home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / wb / huntwin1_4.lha / huntwindows.doc < prev    next >
Text File  |  1992-11-23  |  5KB  |  154 lines
  1.  
  2.  
  3.              Huntwindows V1.4 by Jörg Bublath
  4.              ================================
  5.  
  6.  
  7. COPYRIGHT:
  8.  
  9. Huntwindows V1.4 is freely distributable.
  10. Huntwindows V1.4 is free to be spread on public-domain and shareware disks
  11. especially on Fred Fish's AmigaLibDisks, as long as they are sold for a
  12. reasonable charge that is less than US $6 or DM 8.- .
  13. For use in commercial products the permission of the author is required.
  14. Huntwindows V1.4 may be copied and distributed via electronic networks such
  15. as the Internet, also it may be moved on anonymous ftp-servers,
  16. mail-boxes or BBS's.
  17. The Copyright is still by the Author.
  18. You may use the source for your own non-commercial purposes, but you are
  19. not allowed to spread a changed version under the same name. If you think
  20. you have made a useful change contact me, so I may include it.
  21.  
  22. REQUIREMENTS:
  23.  
  24. Kickstart 2.0 or higher
  25.  
  26.  
  27. PREFACE:
  28.  
  29. Coming with 2.0 you can make screens bigger than the visual size of your
  30. monitor. After I tried to catch windows like requesters etc. on my
  31. double-sized workbench, I got enough and wrote this little tool.
  32. It hangs itself into the VBI to find out which window in being
  33. activated and moves the screen to show the window in full view.
  34.  
  35. USAGE:
  36.  
  37. Template: HADJ/K,VADJ/K,NOFRONT/S,NOMOVE/S,ALWAYS/S,WBONLY/S,WFRONT/S,
  38.       DEFPUB/S,QUIT/S from CLI
  39. or the same options as worbench tooltypes.
  40.  
  41. HADJ=<a>: Horizontal Adjustment:
  42.       l : Left - means that IF scrolling is necessary, huntwindows
  43.           will try to get the window adjusted to the left edge of
  44.           the screen
  45.       r : Same as above with the right edge
  46.       c : Same as above but centering in the screen
  47.       Everything else will switch the adjustment off
  48.  
  49. VADJ=<a>: Horizontal Adjustment:
  50.       t : Top - means that IF scrolling is necessary, huntwindows
  51.           will try to get the window adjusted to the top edge of
  52.           the screen
  53.       b : Same as above with the top edge
  54.       c : Same as above but centering in the screen
  55.       Everything else will switch the adjustment off
  56.  
  57. NOFRONT : Disable the ScreenToFront() whenever a window is activated
  58.       Not giving this option automatically enables the ScreenToFront()
  59.       feature.
  60.  
  61. NOMOVE    : Disable ScreenMove() whenever a window is actived - if the
  62.       option is not given, moving is automatically enabled.
  63.  
  64. ALWAYS    : Turns of the optimization done when a window is already totally
  65.       visible. This will only have any affect if a HADJ or VADJ
  66.       option is set.
  67.  
  68. WBONLY    : Only affect windows on the Workbenchscreen - if something
  69.       happens on another screen it will be ignored.
  70.  
  71. WFRONT    : Do an additional WindowToFront() for windows being activated. This
  72.       will only show effect if you close a window, and the next
  73.       possible active window chosen by the OS is hidden somewhere.
  74.  
  75. DEFPUB    : If the Intuition FirstScreen is a PublicScreen it will automaticly
  76.       set as DefaultPubScreen, so all windows opening on the default will
  77.       use the FirstScreen.
  78.  
  79. QUIT    : Quit an already running installation of Huntwindows. This can
  80.       also be done by breaking the Task (CTRL-C)
  81.  
  82.  
  83. From CLI you will have to start the program in the background via
  84.  
  85.        run <nil: >nil: huntwindows [options]
  86.  
  87. or whatever you like. If you want to quit Huntwindows simply break the
  88. task or type "huntwindows QUIT".
  89.  
  90. From Workbench adjust the tooltypes and simply start by double-clicking.
  91.  
  92. All the options can be changed by simply starting Huntwindows a second
  93. time. CAUTION: The options will be set the same way as if you initially
  94. start Huntwindows. This means that if you skip an option you had set, the
  95. option will be resetted.
  96.  
  97. THANX:
  98.  
  99. Christian 'cschneid' Schneider for technical support and finding bugs
  100. without ever wanting to use this program.
  101. Markus 'ill' Illenseer for ideas.
  102. Michael Suelmann for help with the workbench-support.
  103.  
  104. TECHNICAL:
  105.  
  106. For reaching this Huntwindows installs a Vertical-Blank interrupt-server,
  107. which tests if the ActiveWindow recorded by intuition differs from the
  108. last interrupt and then signals the main-task to move the display.
  109. Don't mind it taking away too much CPU time - if you have a look at the
  110. source at label 'Interrupt3' you will find that it doesn't do anyhing that
  111. is worth arguing about.
  112.  
  113. HISTORY:
  114.  
  115. Version 1.0:
  116. Worked with patching vectors, which didn't solve the problem of getting
  117. every active window completly.
  118.  
  119. Version 1.1:
  120. Now uses VBI for catching active windows.
  121.  
  122. Version 1.2:
  123. Added some new options and removed some bugs.
  124.  
  125. Version 1.3:
  126. WBONLY and WFRONT option added. WFRONT will not make WindowToFront() on
  127. Backdrop and WBENCHWINDOW windows because it causes problems.
  128. Workbenchsupport added.
  129.  
  130. Version 1.4:
  131. Crash when entering wrong arguments removed
  132. Added DEFPUB option
  133.  
  134. FINAL REMARKS:
  135.  
  136. This tool is very nice to be used together with Windowshuffle by
  137. Stefan Sticht, for hopping through the windows and actually seeing them,
  138. when having a BIG workbench.
  139. Huntwindows could do a lot of more interesting things - if I could think
  140. about anything, so if you have ideas please contact me!
  141.  
  142. For problems and ideas, reach me at:
  143.  
  144. EMAIL: bublath@kirk.fmi.uni-passau.de
  145.  
  146. IRC: Skull
  147.  
  148. SMAIL: Jörg Bublath
  149.        Holzheimerstr. 4/E07
  150.        8390 Passau
  151.        Germany
  152.        Phone: Germany-0851-59947
  153.  
  154.